home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / sticpsrc.lzh / DOC / NODE.ARC / NODE.TXT < prev   
Encoding:
Text File  |  1990-06-23  |  16.1 KB  |  549 lines

  1. Configuring a remote-controlled node using NET.PE1CHL
  2.  
  3. Because some nodes are now converting from NET/ROM running on a 
  4. TNC2 clone to a PC or Atari ST, using an SCC (8530) board and 
  5. running TCP/IP NET, some guidelines are collected in this 
  6. document to help configuration of such a node.
  7.  
  8.  
  9. Auto-start of program
  10.  
  11. The system must be configured in such a way, that it will 
  12. automatically start the NET program when powered-up or RESET, and 
  13. will re-start whenever the NET program exits.  This can be easily 
  14. accomplished:
  15.  
  16. -    Atari ST systems:
  17.  
  18.      Create a folder (directory) on the startup disk, named AUTO.
  19.      Copy the NET program into this folder, and name it "NET.PRG" 
  20.      (not NET.TOS, as it is normally distributed).
  21.      After that, copy a program into the AUTO folder that will 
  22.      reboot the machine.  Such programs are available in the 
  23.      public domain, and can be obtained from PE1CHL too.
  24.  
  25. -    MS-DOS systems:
  26.  
  27.      At the end of the AUTOEXEC.BAT file on the startup disk, put 
  28.      the "NET" command to start "NET.EXE", and on the following 
  29.      line put a command to re-boot the system.  Programs to do 
  30.      that are available in the public domain, and are usually 
  31.      called something like "BOOT.COM", "REBOOT.COM" etc.  You can 
  32.      create your own "BOOT.COM" by creating a file with the 5-
  33.      byte sequence "EA 00 00 FF FF", using DEBUG.
  34.  
  35. The effect of the above setup is the same for both machines: 
  36. during the startup procedure the NET program is started, and it 
  37. normally stays running (i.e. the startup procedure never 
  38. terminates).  Should the NET program ever exit, the next line in 
  39. the procedure (or the next program in the AUTO folder) will 
  40. reboot the machine, and the NET program will be re-started.
  41.  
  42.  
  43. Watchdog
  44.  
  45. In the event of a program crash, it is very inconvenient to have 
  46. to reset the machine manually.  Program crashes occur infre-
  47. quently, and only when no operator is watching.
  48. The program has a feature that allows the connection of a 
  49. hardware watchdog circuit, that will RESET the machine when the 
  50. program seems to hang.
  51.  
  52. The principle of such a circuit, is to generate a RESET pulse 
  53. when no activity has been sensed on the input of the circuit 
  54. during a certain interval of time.  The program can generate a 
  55. pulse on some output pin (e.g. a DATA line of the parallel 
  56. printer port) at each pass through the main loop.
  57.  
  58. It is also possible to connect the PTT output of a channel to 
  59. such a circuit, because the channel will always transmit the 
  60. nodelist at fixed intervals, so the node has crashed when the 
  61. transmitter is not activated for a long time.
  62.  
  63. For the Atari version of the program, the watchdog command also 
  64. allows the definition of a software timeout that will cause a 
  65. RESET of the machine after a certain period of inactivity, 
  66. without requiring external hardware.  This method provides some 
  67. protection against crashes, but is less reliable than the 
  68. hardware-assisted approach.
  69.  
  70. The command to activate the watchdog pulses is:
  71.  
  72. -    Atari ST systems:
  73.  
  74.      watchdog 180 600 01
  75.  
  76.      This enables 2 forms of watchdog:
  77.      1.   A software timer that will reset the machine when no 
  78.           activity has occurred for 180 seconds (or for 600 
  79.           seconds when a "shell" command has been given).
  80.      2.   An pulse output will be given on the lowest bit (D0) of 
  81.           the parallel printer output at each pass through the 
  82.           program loop.  Other outputs can be selected by speci-
  83.           fying a different 3rd parameter.  A value of 00 for the 
  84.           3rd parameter will disable the pulses on the parallel 
  85.           output.
  86.  
  87. -    MS-DOS systems:
  88.  
  89.      watchdog xxx xx
  90.  
  91.  
  92. Example configuration files
  93.  
  94. Below, the configuration files in use at PI8NOS (as of June 1990) 
  95. are listed.  These are real-life configuration files, that have 
  96. been in use and have been maintained for nearly a year.
  97.  
  98. The hardware in use at PI8NOS is an Atari Mega-ST2, with an 8-
  99. channel SCC interface and a 300baud modem connected to the AUX 
  100. (RS232) port.
  101.  
  102. ----------------------------------------------------------------
  103. AUTOEXEC.NET
  104. ----------------------------------------------------------------
  105.  
  106. # NET configuration file for PI8NOS network station in Hilversum
  107. # uses special SCC interface board with 4 Z8530s installed
  108. # AUX (rs232) is used as a connection to an async modem for remote control
  109. # MIDI is not used
  110. # Drive A: is a 720K floppy, drive G: is a 1MB RAMDisk
  111. #
  112. setenv NETDISK a:
  113. setenv RAMDISK g:
  114. #
  115. # define buffers for use by SCC driver
  116. memstat 100000
  117. buffers 64 2 128
  118. #
  119. # attach commands for SCC driver.  first init, then attach the channels.
  120. attach scc 4 init fffd00 8 3 7 -2 fffd3f 3 p4915200
  121. #                                               4 thru 7 are spare channels
  122. #attach scc 7 ax25 ax3  256 d4800 pi8nos-8
  123. #attach scc 6 ax25 ax2  256 d4800 pi8nos-7
  124. #attach scc 5 ax25 ax1  256 d4800 pi8nos-6
  125. #attach scc 4 ax25 ax0  256 d4800 pi8nos-5
  126. #                                               3 is west-link on 430.800
  127. attach scc 3 ax25 ln.w 256 d1200 pi8nos-4
  128. #                                               2 is south-link on 1299.900
  129. attach scc 2 ax25 ln.s 256 d1200 pi8nos-3
  130. #                                               1 is east-link on 1240.400/1299.400
  131. attach scc 1 ax25 ln.e 256 d1200 pi8nos-2
  132. #                                               0 is north-link on 1240.800
  133. attach scc 0 ax25 ln.n 256 d1200 pi8nos-1
  134. #
  135. # attach the NET/ROM interface & set the call to be used by NET/ROM level 3
  136. #
  137. attach netrom pi8nos
  138. #
  139. # filtering of unwanted AX.25 stations
  140. #
  141. ax25 exclude nocall
  142. ax25 exclude pi8nos
  143. #
  144. # setup some directories and files. RAMDisk is faster so transfer commonly
  145. # used files like HOSTS.NET to it. FTP public area is also on RAMDisk, and
  146. # is initialized with some of our configuration files.
  147. #
  148. cd ${NETDISK}\net
  149. mkdir -f ${RAMDISK}\tmp ${RAMDISK}\net ${RAMDISK}\net\mqueue ${RAMDISK}\public
  150. #
  151. copy $NETHOSTS ${RAMDISK}\net\hosts.net
  152. setenv NETHOSTS ${RAMDISK}\net\hosts.net
  153. #
  154. setenv TMPDIR ${RAMDISK}\tmp
  155. setenv TMP $TMPDIR
  156. del -f $TMPDIR\*.*
  157. #
  158. copy ${NETMAILQ}*.* ${RAMDISK}\net\mqueue
  159. del -f ${NETMAILQ}*.txt ${NETMAILQ}*.wrk ${NETMAILQ}*.lck
  160. setenv NETMAILQ ${RAMDISK}\net\mqueue\
  161. del -f ${NETMAILQ}*.lck
  162. #
  163. copy ${NETDISK}\net\nr_info.txt ${RAMDISK}\net
  164. copy alias $NETHOSTS routes.net finger\*.txt ${RAMDISK}\public
  165. setenv ENVSTYLE
  166. setenv TIMEZONE MET:0
  167. shell =${NETDISK}\arc.ttp
  168. #
  169. # remainder of configuration
  170. #
  171. source config.net
  172. #
  173. # Addresses, IP routing table and ARP commands, Misc
  174. #
  175. hostname pi8nos.ampr.org
  176. ip address pi8nos
  177. source routes.net
  178. log ${NETDISK}\net\net.log startup
  179. log proc
  180. watchdog 120 600 1
  181. #
  182. # NET/ROM configuration. Filtering and routes are in NETROM.NET
  183. #
  184. netrom info ${RAMDISK}\net\nr_info.txt
  185. netrom interface ln.n "HVS" 224
  186. netrom interface ln.s "HVS" 224
  187. netrom interface ln.e "HVS" 220
  188. netrom interface ln.w "HVS" 192 lap
  189. netrom tcpip link "#TCPIP"
  190. source netrom.net
  191. netrom route save ${RAMDISK}\net\netrom.rts
  192. source ${RAMDISK}\net\netrom.rts
  193. #
  194. # KISS and AX25 stuff for each TNC connected
  195. #
  196. mheard ln.n 23
  197. mheard ln.s 23
  198. mheard ln.e 23
  199. mheard ln.w 23
  200. ax25 digipeat ln.n gate
  201. ax25 digipeat ln.s gate
  202. ax25 digipeat ln.e gate
  203. ax25 digipeat ln.w gate
  204. #ax25 persist ln.n 128 5 128 60 900
  205. #ax25 persist ln.s 128 5 128 60 900
  206. #ax25 persist ln.e 128 5 128 60 900
  207. ax25 persist ln.w 128 24 64 60 900
  208. #
  209. # AX25 ports.  1=TNC 2=NetDigi 3=MHEARD 4=Bridge
  210. #
  211. ax25 port 2 digi pi8nos-9  ln.n gate
  212. ax25 port 2 digi pi8nos-10 ln.e gate
  213. ax25 port 2 digi pi8nos-11 ln.s gate
  214. ax25 port 2 digi pi8nos-12 ln.w gate
  215. ax25 port 3 conn pi8nos-9  ln.n multi
  216. ax25 port 3 conn pi8nos-10 ln.e multi
  217. ax25 port 3 conn pi8nos-11 ln.s multi
  218. ax25 port 3 conn pi8nos-12 ln.w multi
  219. ax25 port 4 conn pi8nos-15
  220. ax25 port 6 conn pi8nos-14
  221. #
  222. # SCC driver interface groups
  223. #
  224. param ln.n group 001
  225. param ln.s group 106
  226. param ln.e group 103
  227. param ln.w group 000
  228. #
  229. # initialize SCC driver on ln.n
  230. #
  231. param ln.n 2 128
  232. param ln.n 7 1
  233. param ln.n 8 15
  234. #
  235. # initialize SCC driver on ln.s
  236. #
  237. param ln.s 2 32
  238. param ln.s 7 100
  239. param ln.s 8 15
  240. #
  241. # initialize SCC driver on ln.e
  242. #
  243. param ln.e 1 50
  244. param ln.e 2 32
  245. param ln.e 7 100
  246. param ln.e 8 15
  247. #
  248. # initialize SCC driver on ln.w
  249. #
  250. param ln.w 2 32
  251. param ln.w 7 100
  252. param ln.w 8 15
  253. #
  254. # send the netrom nodes on startup
  255. #
  256. netrom bcnodes ln.n
  257. netrom bcnodes ln.s
  258. netrom bcnodes ln.e
  259. netrom bcnodes ln.w
  260. #
  261. # now we can safely start all servers
  262. #
  263. start discard
  264. start echo
  265. start finger
  266. start ftp
  267. start smtp
  268. source remote.net
  269. ax25 start bridge
  270. ax25 start mbox ${NETFINGER}network.txt
  271. ax25 start mheard
  272. ax25 start netdigi
  273. #
  274. # commands to be run at specified time-of-day
  275. #
  276. at 00:00 source ${NETDISK}\net\at0000.net
  277. at 06:00 source ${NETDISK}\net\at0600.net
  278. at 12:00 source ${NETDISK}\net\at1200.net
  279. at 18:00 source ${NETDISK}\net\at1800.net
  280. #
  281. # allow control from AUX port 300 baud / 8 bits / no flow control
  282. #
  283. auxcon 11 300 8 noflow
  284. #
  285. hostname
  286. ip address
  287.  
  288. ----------------------------------------------------------------
  289. CONFIG.NET
  290. ----------------------------------------------------------------
  291.  
  292. # remainder of configuration
  293. # SMTP options
  294. #
  295. #smtp gateway ...
  296. smtp maxclients 5
  297. smtp mode route
  298. smtp timer 4000 300
  299. #
  300. # Telnet options
  301. #
  302. echo refuse
  303. eol standard
  304. #
  305. # TCP parameters
  306. #
  307. tcp irtt 15000
  308. tcp mss 512
  309. tcp timeout 7200
  310. tcp window 432
  311. #
  312. # IP parameters
  313. #
  314. ip ttl 10
  315. #
  316. # ICMP parameters
  317. #
  318. ping length 0
  319. #
  320. # AX25 parameters
  321. #
  322. ax25 digipeat on
  323. ax25 maxframe 4
  324. ax25 maxsamml 7
  325. ax25 paclen 256
  326. ax25 pthresh 64
  327. ax25 retry 10
  328. ax25 t1 15000
  329. ax25 t2 1500
  330. ax25 t3 1800000
  331. ax25 t4 900000
  332. ax25 window 2048
  333. #
  334. # NET/ROM parameters
  335. #
  336. netrom nodetimer 1800
  337. netrom obsotimer 1800
  338. netrom param 3 80 6 5 16 3 16 2
  339. netrom param 4 180 3 3 180 10 15 1800
  340. #
  341. # Misc settings
  342. #
  343. escape F10
  344. flow on
  345. screen direct
  346.  
  347. ----------------------------------------------------------------
  348. ROUTES.NET
  349. ----------------------------------------------------------------
  350.  
  351. # IP routing table for PI8NOS
  352. #
  353. # ARP statements for AX.25 stations
  354. #
  355. arp add pa3ayb          ax25:ln.s pa3ayb-7 pi8rni-1 pi8rni-7 pi8ayb-7
  356. arp add pa3azk          ax25:ln.s pa3azk-7 pi8rni-1 pi8rni-7
  357. arp add pa3fmc          ax25:ln.s pa3fmc-9 pi8rni-1 pi8rni-7
  358. arp add pe1dcy          ax25:ln.s pe1dcy-7 pi8rni-1 pi8rni-7
  359. arp add pe1krc          ax25:ln.s pe1krc-7 pi8rni-1 pi8rni-7
  360. #
  361. # ARP statements and ROUTES for NET/ROM stations
  362. #
  363. route add dd9qp         netrom
  364. arp   add dd9qp         netrom  dd9qp-9
  365. route add pa0mjr        netrom
  366. arp   add pa0mjr        netrom  pa0mjr-9
  367. route add pa0sgl        netrom
  368. arp   add pa0sgl        netrom  pa0sgl-9
  369. route add pa3bat        netrom
  370. arp   add pa3bat        netrom  pa3bat-9
  371. route add pa3bba        netrom
  372. arp   add pa3bba        netrom  pa3bba-7
  373. route add pa3bzt        netrom
  374. arp   add pa3bzt        netrom  pa3bzt-9
  375. route add pa3ecp-7      netrom
  376. arp   add pa3ecp-7      netrom  pa3ecp-7
  377. route add pa3fbg        netrom
  378. arp   add pa3fbg        netrom  pa3fbg-2
  379. route add pe0mar        netrom
  380. arp   add pe0mar        netrom  pe0mar
  381. route add pe0mar-7      netrom
  382. arp   add pe0mar-7      netrom  pe0mar-3
  383. route add pe1ayx        netrom
  384. arp   add pe1ayx        netrom  pi8hrl-9
  385. route add pe1btv        netrom
  386. arp   add pe1btv        netrom  pe1btv-9
  387. route add pe1chl        netrom
  388. arp   add pe1chl        netrom  pe1chl-9
  389. route add pe1dna        netrom
  390. arp   add pe1dna        netrom  pe1dna-9
  391. route add pi8eae        netrom
  392. arp   add pi8eae        netrom  pi8eae-9
  393. route add pi8gtb        netrom
  394. arp   add pi8gtb        netrom  pi8gtb-7
  395. route add pi8mac        netrom
  396. arp   add pi8mac        netrom  pi8mac
  397. route add pi8mid        netrom
  398. arp   add pi8mid        netrom  pi8mid-7
  399. #
  400. # set direct route for nearby networks (no default, to get unreachable mesgs)
  401. #
  402. route add Holland/16    ln.w
  403. #
  404. # Exceptions to gateway routings
  405. #
  406. route add pa0ma         ln.w
  407. route add pa3ayb        ln.s
  408. route add pa3azk        ln.s
  409. route add pa3eae        ln.w
  410. route add pa3eoa        ln.w
  411. route add pa3fmc        ln.s
  412. route add pb0aaq        ln.w
  413. route add pe1dcy        ln.s
  414. route add pe1kaq        ln.w
  415. route add pe1krc        ln.s
  416. #
  417. # stations reachable via (their own private) gateways
  418. #
  419. route add pa2aga        via     pi8mac
  420. route add pa3cay        via     pa3fmc
  421. route add pa3ecp        via     pa3ecp-7
  422. route add pa3ein        via     pe1chl
  423. route add sys2.pe1chl   via     pe1chl
  424. #
  425. # some networks reachable via gateways
  426. #
  427. route add Germany/16    via     dd9qp
  428. route add PA_DRnet/22   via     pa0adc
  429. route add PA_FLnet/22   via     pe1kaq
  430. route add PA_FRnet/22   via     pa3dvg
  431. route add PA_GLnet/22   via     dd9qp
  432. route add PA_GRnet/22   via     pa3dvg
  433. route add PA_LBnet/22   via     pe1ayx
  434. route add PA_NBOnet/22  via     pe1dna
  435. route add PA_NBWnet/22  via     pi8gtb
  436. route add PA_NH1net/22  via     pe1btv
  437. route add PA_NH2net/22  via     pa3fmc
  438. route add PA_OVnet1/22  via     pa3daz
  439. route add PA_UTnet/22   via     pe1chl
  440. route add PA_ZH1net/22  via     pa3ecp-7
  441. route add PA_ZH2net/22  via     pe0mar-7
  442. route add PA_ZLnet/22   via     pa3ecp-7
  443.  
  444. ----------------------------------------------------------------
  445. NETROM.NET
  446. ----------------------------------------------------------------
  447.  
  448. # NET/ROM routes and filters for PI8NOS
  449. # only the nodes in the list below are accepted for automatic route table
  450. # updates (NODES broadcasts).  this is controlled by the "mode accept".
  451. #
  452. netrom nodefilter mode accept
  453. #
  454. # SYSOP has access to all ports (in case of problems)
  455. #
  456. netrom nodefilter add pe1chl-9  ln.e
  457. netrom nodefilter add pe1chl-9  ln.n
  458. netrom nodefilter add pe1chl-9  ln.s
  459. netrom nodefilter add pe1chl-9  ln.w
  460. #
  461. netrom nodefilter add pa3dzi    ln.n
  462. netrom nodefilter add pa3dzi-1  ln.n
  463. netrom nodefilter add pa3dzi-3  ln.n
  464. netrom nodefilter add pa3ecp-7  ln.w
  465. netrom nodefilter add pi8eae    ln.w
  466. netrom nodefilter add pi8eae-9  ln.w
  467. netrom nodefilter add pi8esa-7  ln.w
  468. netrom nodefilter add pi8rni-1  ln.s
  469. netrom nodefilter add pi8vrz-1  ln.e
  470. #
  471. # a list of nodes never accepted in node broadcasts.  these are known to have
  472. # fixed nodelists and parameters set in such a way that connecting them from
  473. # here is impossible (they don't accept new nodes)
  474. #
  475. netrom exclude on1abt
  476. netrom exclude on1anr
  477. netrom exclude on1apd
  478. netrom exclude on1awb
  479. netrom exclude on1kgx
  480. netrom exclude on4awp
  481. netrom exclude on4cp
  482. netrom exclude on4hu
  483. netrom exclude on5pl
  484. netrom exclude on6nr
  485. netrom exclude on6or
  486. netrom exclude on6rm
  487. netrom exclude on7an
  488. netrom exclude on7rc
  489.  
  490. ----------------------------------------------------------------
  491. REMOTE.NET
  492. ----------------------------------------------------------------
  493.  
  494. # commands to start remote-control servers
  495. # put in a separate file so that we don't have to send it every time
  496. # autoexec.net is updated (somebody could be monitoring us)
  497. #
  498. start rcmd 333 "dsfjkaewrqbefndscuwerfjasfvaaaaarughrueggdfv"
  499. start remote 3534
  500.  
  501. ----------------------------------------------------------------
  502. ONEXIT.NET
  503. ----------------------------------------------------------------
  504.  
  505. # this file will be executed on "exit" from NET
  506. #
  507. copy ${NETMAILQ}*.* ${NETDISK}\net\mqueue
  508. del ${NETMAILQ}*.*
  509. netrom route save
  510.  
  511. ----------------------------------------------------------------
  512. AT0000.NET
  513. ----------------------------------------------------------------
  514.  
  515. # commands executed each day at 00:00
  516. #
  517. copy ${RAMDISK}\net\mqueue\sequence.seq ${NETDISK}\net\mqueue
  518.  
  519. ----------------------------------------------------------------
  520. AT0600.NET
  521. ----------------------------------------------------------------
  522.  
  523. # commands executed each day at 06:00
  524. #
  525.  
  526. ----------------------------------------------------------------
  527. AT1200.NET
  528. ----------------------------------------------------------------
  529.  
  530. # commands executed each day at 12:00
  531. #
  532. copy ${RAMDISK}\net\mqueue\sequence.seq ${NETDISK}\net\mqueue
  533.  
  534. ----------------------------------------------------------------
  535. AT1800.NET
  536. ----------------------------------------------------------------
  537.  
  538. # commands executed each day at 18:00
  539. #
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547. Rob PE1CHL
  548.  
  549.